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3 

4 APIs (Java style) that can conveniently be used to deal with persistence of objects. 

5 None of these APIs assumes knowledge of SQL. 
6 

7 void open(String databaseURL) 

8 Opens the database connection and intializes the data structures as per the 

9 Object-Relational Mapping specification corresponding to an ORMId or an 
10 ORMFile specified in the databaseURL. 

11 

12 Vector query(String className, String predicate, long maxObjects, long queryFlags, 

13 Vector queryDetails) 

14 Returns a list of objects of the given class satisfying the given search condition 

15 (predicate). If maxObjects is -1 then all the relevant objects are returned else upto 

16 a maximum of maxObjects objects are returned. queryFlags, among other 

17 things, specifies if it is a deep query (i.e., all the referenced objects are also 

18 retrieved) or shallow query (i.e., just the top-level object is retrieved) Default 

19 behavior is deep query. If queryFlag is set for the streaming mode then 

20 maxObjects are returned and additional objects may be retrieved using 

21 query Fetch() API described below. QueryDetails parameter specifies directed 

22 operation options which may be used to control the query in different ways. 
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2 Vector query Fetch(long maxObjects, long queryFlags, Vector queryDetails) 

3 Returns a list of upto maxObjects following objects from the object stream 

4 opened by a previous call to query(). This is allowed in the same transaction in 

5 which the query() call was initiated. QueryDetails parameter specifies directed 

6 options which may be used to control the query in different ways. 
7 

8 void queryClose() 

9 Closes the current object stream. 
10 

11 public void insert(Object object, long insertFlags, Vector insertDetails) 

12 Inserts the given object and all its referenced objects that are contained by value. 

13 InsertFlags specifies if it is a deep insertion (i.e., all the referenced by value 

14 objects are also inserted) or shallow insertion (i.e., just the top-level object is 

15 inserted). Default behavior is deep insert insertDetails parameter specifies 

16 directed options that may be used to further control the insert operation in 

17 different ways. 
18 

19 public void update(Object object, long updateFlags, Vector updateDetails) 

20 Updates the given object and all its referenced objects which are contained by 

21 value. The default update semantics are such that the existing persistent copy of 

22 the object in the database is replaced by the new updated object. updateFlags 
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1 specifies if it is a deep update (i. e., all the referenced by value objects are also 

2 updated) or shallow update (i. e., just the top-level object is updated). Default 

3 behavior is deep update. updateDetails parameter specifies directed options 

4 which may be used to further control the update operation in different ways. 
5 



6 public long update2(String className, String predicate, Vector new Values, long 

7 updateFlags) 



8 Updates all objects of the given class satisfying the given search condition 

9 (predicate) as per the new attribute values. NewValues parameter is a vector of 

10 names and values of updated attributes. (Only shallow update, in this case). 

11 Returns the number of updated objects. 
12 

13 public void delete(Object object, long deleteFlags, Vector deleteDetails) 

14 Deletes the given object and all its referenced objects which are contained by 

15 value. deleteFlags specifies if it is a deep delete (i. e., all the referenced by value 

16 objects are also deleted) or shallow delete (i. e., just the top-level object is 

17 deleted). Default behavior is deep delete. 
18 

19 public long delete2(String className, String predicate, long deleteFlags) 

20 Deletes all objects of the given class satisfying the given search condition 

21 (predicate). deleteFlags specifies if it is a deep delete (i. e., all the referenced by 

22 value objects are also deleted) or shallow delete (i. e., just the top-level object is 
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deleted). Default behavior is deep delete. Returns the number of deleted 



objects. 



public long getNextSequence(String sequenceName, long increment) 
throws RemoteException, JDXException; 

Returns the next available sequence number for the given sequenceName. The 
persistent sequence number in the database is incremented by v increment' such 
that the calling application can safely assume that no other application would 
get the next sequence number in the range of (returned sequence number n, 
n+increment-1) both inclusive. In other words, this range 
(n, n+increment-1) presents a unique set of numbers with respect to the given 
sequenceName across all applications accessing the same RDBMS. These 
sequence numbers can typically be used to assign unique ids to different objects. 
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